home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 March / EnigmA AMIGA RUN 05 (1996)(G.R. Edizioni)(IT)[!][issue 1996-03][Skylink CD IV].iso / earcd / program / nwstrn11.lha / NewString11 / NewStringHook.doc < prev    next >
Text File  |  1996-01-16  |  4KB  |  151 lines
  1.  
  2.  
  3.              NewStringHook 1.1 (C) Copyright 1995 Doguet Emmanuel
  4.  
  5.                                  (12.12.95)
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  COPYRIGHTS
  12.  ----------
  13.  
  14.  This Link-libraries are Freeware. They can be distribute  on  Disk,  CD-ROM,
  15.  servers, networks, magasines..
  16.  
  17.  If you use it on your program,  please  insert  in  your  documentation  the
  18.  copyright of the StringHook, something like:
  19.  
  20.     'This program use the NewStringHook (C) Copyright 1995-1996 Doguet Emmanuel'
  21.  
  22.  And please send me a post card.
  23.  
  24.  
  25.   For post card, suggestion, report or greeting:
  26.   ----------------------------------------------
  27.  
  28.   DOGUET Emmanuel
  29.   4, rue de Cornouailles
  30.   50130 OCTEVILLE
  31.   FRANCE
  32.  
  33.   Usenet:    manu@ramses.fdn.org
  34.   Fidonet:   2:320/104.64
  35.  
  36.  
  37.  
  38.  INTRODUCTION
  39.  ------------
  40.  
  41.  The string class of intuition.library have a bug, we  can't  set  an  entire
  42.  string  of  character  it  only  display  MAX.CHAR. -1. For example, when we
  43.  create a string with 5 max. char. and we want to set ( SetGadgetAttrs.. )  a
  44.  string on it, it will display only the 4 first characters.
  45.  
  46.  This link-librarie contain 3 hook who repair this BUG !
  47.  
  48.  
  49.  FEATURES
  50.  --------
  51.  
  52.  The librarie contain 3 HOOK: StringHook, StringHookReturn and StringHookCommand.
  53.  
  54.  They repair the Intuition bug, but they have too.. :
  55.  
  56.  
  57.     * StringHook:
  58.  
  59.         - ALT-CURSOR (UP|DOWN): go to another string (if TABCYCLE-MODE ON).
  60.  
  61.         - ESC: Deactive the string gadget.
  62.  
  63.  
  64.  
  65.     * StringHookReturn:
  66.  
  67.         - ALT-CURSOR (UP|DOWN): go to another string (if TABCYCLE-MODE ON).
  68.  
  69.         - ESC: Deactive the string gadget.
  70.  
  71.         - RETURN: When you validate a string, it will activate the next string-gadget
  72.          (if TABCYCLE-MODE ON).
  73.  
  74.  
  75.  
  76.     * StringHookCommand:
  77.  
  78.         - ALT-CURSOR (UP|DOWN): go to another string (if TABCYCLE-MODE ON).
  79.  
  80.         - ESC:  Deactive  the  string  gadget.
  81.  
  82.         - When RAMIGA or LAMIGA with a <char>, it will active button who have
  83.           the shortcut: <char> or menu who have the shortcut LAMIGA + <char>.
  84.  
  85.  
  86.  
  87.  PACKAGE
  88.  -------
  89.  
  90.     Dice/StringHookS.lib        ......... Link-libraries for DICE Pro
  91.     Dice/StringHookSR.lib
  92.  
  93.     SAS/StringHook.lib          ......... Link-libraries for SAS/C
  94.  
  95.     Include/StringHook.h        ......... C-Include
  96.     Include/NewString_macros.h  ......... C-macros for BGUI users
  97.  
  98.     Demo                        ......... Demo of the hook 
  99.                                           ( need the bgui.library ).
  100.  
  101.     NewStringHook.doc           ......... This documentation!
  102.  
  103.  
  104.  USAGE
  105.  -----
  106.  
  107.  If you want a string  gadget  with  5  characters,  create  it  with  6  max
  108.  characters,  the  hook  will  stop the edition at MAX - 1 characters also we
  109.  can't enter only 5 characters.
  110.  
  111.  And affect the hook to your string gadget, it will do something like:
  112.  
  113.     [....]
  114.     STRINGA_MaxChars,      max + 1,
  115.     STRINGA_EditHook,      (ULONG)&StringHook,
  116.     [....]
  117.  
  118.     or
  119.  
  120.     [....]
  121.     STRINGA_MaxChars,      max + 1,
  122.     STRINGA_EditHook,      (ULONG)&StringHookReturn,
  123.     [....]
  124.  
  125.  
  126.  For users of the bgui.library, you can use the macro in "NewString_macros.h".
  127.  
  128.  
  129.  DISCLAIMER
  130.  ----------
  131.  
  132.  In spite of numerous tests, I can't guarantee that this  hooks  contains  no
  133.  errors.  You  use  this at your own risk. I won't be in charge if the use of
  134.  hooks is responsible for any direct or indirect damages.
  135.  
  136.  
  137.  
  138.  HISTORY
  139.  -------
  140.  
  141.  Version                        Description
  142.  ------------------------------------------------------------------------------------
  143.  1.0                            First release.
  144.  1.1                            Add new hook, for enable Left or Right Amiga command
  145.                                 (see above).
  146.  
  147.  
  148.  
  149.  
  150. **END**
  151.